Custom Workers

Create and run custom background analysis workers with composable phases. Use when you need automated code analysis, security scanning, pattern learning, or API documentation generation.

Invalid

This skill can't be scored yet

Validation errors are blocking scoring. Review and fix them to unlock Quality, Impact and Security scores. See what needs fixing →

Custom Workers

Build composable background analysis workers with 24 phase executors and 6 presets.

Quick Start

# List available presets
npx ruvector workers presets

# List available phase executors
npx ruvector workers phases

# Create a custom worker from preset
npx ruvector workers create my-scanner --preset security-scan

# Run the worker
npx ruvector workers run my-scanner --path ./src

Available Presets

Preset	Description	Phases
`quick-scan`	Fast file discovery and stats	file-discovery → summarization
`deep-analysis`	Comprehensive code analysis	file-discovery → static-analysis → complexity-analysis → import-analysis → pattern-extraction → graph-build → vectorization → summarization
`security-scan`	Security-focused analysis	file-discovery → security-analysis → secret-detection → dependency-discovery → report-generation
`learning`	Pattern learning and memory	file-discovery → pattern-extraction → embedding-generation → pattern-storage → sona-training
`api-docs`	API endpoint documentation	file-discovery → api-discovery → type-analysis → report-generation
`test-analysis`	Test coverage analysis	file-discovery → static-analysis → pattern-extraction → summarization

Phase Executors (24 total)

Discovery Phases

file-discovery - Find files matching patterns
pattern-discovery - Discover code patterns
dependency-discovery - Map dependencies
api-discovery - Find API endpoints

Analysis Phases

static-analysis - AST-based code analysis
complexity-analysis - Cyclomatic complexity
security-analysis - Security vulnerability scan
performance-analysis - Performance bottlenecks
import-analysis - Import/export mapping
type-analysis - TypeScript type extraction

Pattern Phases

pattern-extraction - Extract code patterns
todo-extraction - Find TODOs/FIXMEs
secret-detection - Detect hardcoded secrets
code-smell-detection - Identify code smells

Build Phases

graph-build - Build code graph
call-graph - Function call graph
dependency-graph - Dependency graph

Learning Phases

vectorization - Convert to vectors
embedding-generation - ONNX embeddings (384d)
pattern-storage - Store in VectorDB
sona-training - SONA reinforcement learning

Output Phases

summarization - Generate summary
report-generation - Create report
indexing - Index for search

YAML Configuration

Create workers.yaml in your project:

version: '1.0'
workers:
  - name: auth-scanner
    triggers: [auth-scan, scan-auth]
    phases:
      - type: file-discovery
        config:
          patterns: ["**/auth/**", "**/login/**"]
      - type: security-analysis
      - type: secret-detection
      - type: report-generation
    capabilities:
      onnxEmbeddings: true
      vectorDb: true

  - name: api-documenter
    triggers: [api-docs, document-api]
    phases:
      - type: file-discovery
        config:
          patterns: ["**/routes/**", "**/api/**"]
      - type: api-discovery
      - type: type-analysis
      - type: report-generation

Load configuration:

npx ruvector workers load-config --file workers.yaml

CLI Commands

# Core commands
npx ruvector workers presets       # List presets
npx ruvector workers phases        # List phases
npx ruvector workers create <name> --preset <preset>
npx ruvector workers run <name> --path <path>

# Configuration
npx ruvector workers init-config   # Generate workers.yaml
npx ruvector workers load-config   # Load from workers.yaml
npx ruvector workers custom        # List registered workers

# Monitoring
npx ruvector workers status        # Worker status
npx ruvector workers results       # Analysis results
npx ruvector workers stats         # Statistics

MCP Tools

Available via ruvector MCP server:

Tool	Description
`workers_presets`	List available presets
`workers_phases`	List phase executors
`workers_create`	Create custom worker
`workers_run`	Run worker on path
`workers_custom`	List custom workers
`workers_init_config`	Generate config
`workers_load_config`	Load config

Capabilities

Workers can use these capabilities:

ONNX Embeddings: Real transformer embeddings (all-MiniLM-L6-v2, 384d, SIMD)
VectorDB: Store and search embeddings with HNSW indexing
SONA Learning: Self-Organizing Neural Architecture for pattern learning
ReasoningBank: Trajectory tracking and meta-learning

Integration with Hooks

Workers auto-dispatch on UserPromptSubmit via trigger keywords:

Type "audit this code" → triggers audit worker
Type "security scan" → triggers security worker
Type "learn patterns" → triggers learning worker

Example: Security Scanner

# Create from security-scan preset
npx ruvector workers create security-checker --preset security-scan --triggers "security,vuln,cve"

# Run on source
npx ruvector workers run security-checker --path ./src

# View results
npx ruvector workers results

Example: Custom Learning Worker

# workers.yaml
workers:
  - name: code-learner
    triggers: [learn, pattern-learn]
    phases:
      - type: file-discovery
        config:
          patterns: ["**/*.ts", "**/*.js"]
          exclude: ["node_modules/**"]
      - type: static-analysis
      - type: pattern-extraction
      - type: embedding-generation
      - type: pattern-storage
      - type: sona-training
    capabilities:
      onnxEmbeddings: true
      vectorDb: true
      sonaLearning: true

Repository: ruvnet/ruvector
Commit: 462536e

Last updated: about 17 hours ago
Created: about 17 hours ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.